Skip Headers

Oracle® Data Provider for .NET Developer's Guide 10g Release 2 (10.2) Part Number B14307-01 |
Home | Book List | Contents | Index | Master Index | Feedback

Previous | Next
| View PDF

# OracleNotificationRequest Class

An `OracleNotificationRequest` class represents a notification request to be subscribed in the database. It contains information about the request and the characteristics of the notification. Using the `OracleNotificationRequest` class, Oracle Data Provider for .NET can create the notification registration in the database.

Class Inheritance

`Object`

`OracleNotificationRequest`

Declaration

    // C#
    public sealed class OracleNotificationRequest

Thread Safety

All public static methods are thread-safe, although methods do not guarantee thread safety.

Requirements

Namespace: `Oracle.DataAccess.Client`

Assembly: `Oracle.DataAccess.dll`

Comment: Not supported in a .NET stored procedure

See Also: "Oracle.DataAccess.Client Namespace" OracleNotificationRequest Members OracleNotificationRequest Static Methods OracleNotificationRequest Properties OracleNotificationRequest Methods

## OracleNotificationRequest Members

`OracleNotificationRequest` members are listed in the following tables:

OracleNotificationRequest Static Method

The `OracleNotificationRequest` static method is listed in Table 7-12.

Table 7-12 OracleNotificationRequest Static Method

Static Method | Description
--- | ---
`Equals` | Inherited from `Object`

OracleNotificationRequest Properties

`OracleNotificationRequest` properties are listed in Table 7-13.

Table 7-13 OracleNotificationRequest Properties

Properties | Description
--- | ---
IsNotifiedOnce | Indicates whether or not the registration is to be removed upon notification
IsPersistent | Indicates whether or not the invalidation message should be queued persistently in the database before delivery
Timeout | Specifies the time that the registration remains alive

OracleNotificationRequest Methods

`OracleNotificationRequest` methods are listed in Table 7-14.

Table 7-14 OracleNotificationRequest Methods

Methods | Description
--- | ---
`Equals` | Inherited from `Object`
`GetHashCode` | Inherited from `Object`
`GetType` | Inherited from `Object`
`ToString` | Inherited from `Object`

See Also: "Oracle.DataAccess.Client Namespace" OracleNotificationRequest Members OracleNotificationRequest Class

## OracleNotificationRequest Static Methods

The `OracleNotificationRequest` static method is listed in Table 7-15.

Table 7-15 OracleNotificationRequest Static Method

Static Method | Description
--- | ---
`Equals` | Inherited from `Object`

See Also: "Oracle.DataAccess.Client Namespace" OracleNotificationRequest Members OracleNotificationRequest Class

## OracleNotificationRequest Properties

The `OracleNotificationRequest` properties are listed in Table 7-16.

Table 7-16 OracleNotificationRequest Properties

Properties | Description
--- | ---
IsNotifiedOnce | Indicates whether or not the registration is to be removed upon notification
IsPersistent | Indicates whether or not the invalidation message should be queued persistently in the database before delivery
Timeout | Specifies the time that the registration remains alive

See Also: "Oracle.DataAccess.Client Namespace" OracleNotificationRequest Members OracleNotificationRequest Class

### IsNotifiedOnce

This property indicates whether or not the registration is to be removed upon notification.

Declaration

    // C#
    public bool IsNotifiedOnce{get; set;}

Property Value

A `bool` value that indicates whether or not the registration is to be removed upon notification.

Remarks

Modifying this property after the completion of a successful registration has no effect.

See Also: "Oracle.DataAccess.Client Namespace" OracleNotificationRequest Members OracleNotificationRequest Class

### IsPersistent

This property indicates whether or not the invalidation message should be queued persistently in the database before delivery.

Declaration

    // C#
    public bool IsPersistent{get; set;}

Property Value

A `bool` value that indicates whether or not the invalidation message should be queued persistently in the database before delivery.

When the `IsPersistent` property is set to `True`, the message is queued persistently in the database and cannot be lost upon database failures or shutdowns. When the `IsPersistent` property is set to `False`, the message is stored in an in-memory queue before delivery and could be lost.

Remarks

Modifying this property after the completion of a successful registration has no effect.

The database performs faster if the message is stored in an in-memory queue rather than a database queue.

See Also: "Oracle.DataAccess.Client Namespace" OracleNotificationRequest Members OracleNotificationRequest Class

### Timeout

This property specifies the time that the registration remains alive.

Declaration

    // C#
    public long Timeout{get; set}

Property Value

A `long` value that specifies the time that the registration remains alive. The valid values for the `Timeout` property are between `0` and `4294967295`.

Exceptions

`ArgumentOutOfRangeException` - The specified `Timeout` is invalid.

Remarks

Modifying this property after the completion of a successful registration has no effect.

When the `Timeout` property is set to `0`, the registration does not expire.

When the registration is removed because the registration has expired, the database sends a notification indicating the expiration.

See Also: "Oracle.DataAccess.Client Namespace" OracleNotificationRequest Members OracleNotificationRequest Class

## OracleNotificationRequest Methods

`OracleNotificationRequest` methods are listed in Table 7-17.

Table 7-17 OracleNotificationRequest Methods

Methods | Description
--- | ---
`Equals` | Inherited from `Object`
`GetHashCode` | Inherited from `Object`
`GetType` | Inherited from `Object`
`ToString` | Inherited from `Object`

See Also: "Oracle.DataAccess.Client Namespace" OracleNotificationRequest Members OracleNotificationRequest Class